home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / GAMES / CAVERNDUEL.ZIP / !CavernEd / Documents / !Help next >
Text File  |  1997-12-05  |  19KB  |  396 lines
  1. !CavernEd, version 1.37 (4th December, 1997)
  2.  
  3.                 ______                     ______  _____
  4.                /           /\  \        / /       |     \ |\    |
  5.                |          /  \  \      /  |       |     | | \   |
  6.                |         /    \  \    /   +------ |_____/ |  \  |
  7.                |        /------\  \  /    |       |    \  |   \ |
  8.                \______ /        \  \/     \______ |     \ |    \|
  9.                
  10.                          ______             _____
  11.                          |     \  |      | /      |
  12.                          |      | |      | |      |
  13.                          |      | |      | +----- |
  14.                          |      | |      | |      |
  15.                          |_____/   \____/  \_____ |_____
  16.                          
  17.                   ______ ______   _____ _______  _____   _____
  18.                  /       |     \    |      |    /     \ |     \
  19.                  |       |      |   |      |    |     | |     |
  20.                  +------ |      |   |      |    |     | |_____/
  21.                  |       |      |   |      |    |     | |    \
  22.                  \______ |_____/  __|__    |    \_____/ |     \
  23.                          
  24.                          
  25.                         An original program by Graeme Scott
  26.                         Made multi-tasking by Stephen Scott
  27.          (with the aid of !WimpEd by Joe Taylor © Archimedes World 1992)
  28.                        
  29.                   © tapestry multimedia June 1994 - December 1997  
  30.                         
  31.                   For use with !CavenDuel versions 1.21 and above
  32.                              
  33.   /\
  34.   \/  INTRODUCTION
  35.       
  36.       Welcome to the Cavern Duel Editor text file (or document if you've
  37.       printed this out!). This text will explain how to load and use the
  38.       editor.
  39.       
  40.       Version 1.37 is the first release of this software to the public,
  41.       and as such is lacking in features. It's taken me six months alone
  42.       just to get the Wimp code working at this stage, so I've kept it
  43.       very simple for easy use. It is unlikely that the editor will be
  44.       improved, except for bug fixes. The program is provided "as is"
  45.       and we cannot be held responsible for any data loss caused by its
  46.       use.
  47.       
  48.       The editor allows you to design your own CaveFiles for use in the
  49.       Cavern Duel game. They can then be dragged to the !CavenDuel icon
  50.       to play (after saving the CaveFile to disc/hard disc beforehand!),
  51.       or be moved into the Screens directory inside the !CavenDuel
  52.       application structure for loading within the game. See the
  53.       !CavenDuel documentation for details on how to implement this
  54.       feature.
  55.       
  56.       The editor allows you to design a CaveFile of any size up to a 
  57.       maximum of eight screens long, and four screens high, making 32
  58.       interconnected screens, of 16x16 icons. You can only edit one
  59.       CaveFile at a time, although there is nothing wrong in loading
  60.       another copy of !CavernEd to edit another at the same time.
  61.       
  62.   /\
  63.   \/  LOADING THE EDITOR
  64.       
  65.       If the Cavern Duel software is in an archive, and you have a read
  66.       only version of the dearchiver, then you will need to copy all the
  67.       software out of the archive, otherwise you cannot save CaveFiles.
  68.       
  69.       To load the Cavern Duel Editor, double-click on the !CavernEd icon
  70.       in your chosen directory. After a few seconds, the same icon will
  71.       appear on the right hand side of the icon bar on the desktop.
  72.       
  73.       Alternatively, you can double-click on any CaveFile to load the
  74.       editor. Unfortunately, in this version (1.37) that CaveFile will
  75.       not be loaded for editing. Any help on this would be appreciated.
  76.       
  77.       Clicking the Menu (middle) mouse button on the icon will bring up
  78.       the following menu:
  79.       
  80.           Info >        Leads to a dialogue box showing the version and
  81.                         author information.
  82.           Instructions  Loads this text into a text editor such as !Edit
  83.                         or !Zap.
  84.           Quit          Quits the program.
  85.        
  86.       To edit a new CaveFile, click Select on the !CavernEd icon, or drag
  87.       a CaveFile to the !CavernEd icon. In either case, three windows
  88.       will pop up. These windows will be described in the next section.  
  89.       
  90.   /\
  91.   \/  USING THE EDITOR
  92.   
  93.       The editor uses three windows, called the editor window, map window
  94.       and icons window.
  95.       
  96.          * THE EDITOR WINDOW
  97.          
  98.          This is the largest of the windows, and shows the currently 
  99.          selected screen. The title bar will show the coordinates of this 
  100.          screen in relation to the map window (see later).
  101.   
  102.          Pressing Menu over this window will bring up another menu.
  103.   
  104.             Info - Shows program information.
  105.   
  106.             Save - A standard savebox. 
  107.     
  108.          The other mouse buttons are used to draw inside the currently  
  109.          selected screen. Two different icons can be used at once. By  
  110.          default, Select draws simple paths, while Adjust draws with 
  111.          the eraser icon. These icons will be explained later.
  112.   
  113.          * THE MAP WINDOW
  114.          
  115.          This window displays an 8 x 4 matrix of the cavern system, 32
  116.          screens in all. To display a particular screen, just click on 
  117.          the required map icon, and the window will be updated. 
  118.          
  119.          * THE ICONS WINDOW
  120.          
  121.          This window looks more complex than the others. It shows the 
  122.          available icons required for building the cavern system, and for
  123.          placing specific objects. The icons are split into distinct
  124.          groups.
  125.   
  126.          At the bottom of this window are the currently selected draw and
  127.          erase icons. By default, the draw icon is a stone block, while the 
  128.          erase icon is a grey path. These icons are described below. To 
  129.          select a new draw icon, use the Select button, and the Adjust 
  130.          button for a new erase icon.
  131.   
  132.          Here is a description of the game icons:
  133.   
  134.             * PATH ICONS: There are six icons under this section, five of 
  135.             which can be walked on. From left to right, going down, they
  136.             are:
  137.                
  138.                Grey path icon : a normal path icon.
  139.                
  140.               Grey paved icon : a normal path icon.
  141.                
  142.               Brown tile icon : a normal, but prettier path icon.
  143.                
  144.              Purple path icon : This is the first of three special path 
  145.                                 icons under this section. This one doesn't
  146.                                 allow any objects to be placed at random 
  147.                                 on it, leaving very bare areas if used 
  148.                                 excessively.
  149.                                 
  150.           Disguised path icon : Looks like one of the block icons, doesn't 
  151.                                 it? Well it isn't!
  152.                                 
  153.                Null path icon : This icon allows nothing at all to be 
  154.                                 placed on it. This is useful for defining
  155.                                 strange shape caverns, such as circular
  156.                                 ones. The outer areas can be painted with
  157.                                 this icon, to stop objects being placed
  158.                                 out of reach, or you from being teleported
  159.                                 out into nowhere
  160.                                 
  161.                                 The "Complex" and "MontMyrder" CaveFiles 
  162.                                 are very good examples of the use of this
  163.                                 icon. Load them in now and have a look.
  164.                                 If you do this, then a message will pop up
  165.                                 - this will be explained later.
  166.                                 
  167.             * ITEM ICONS: Again, there are six icons which are all of use 
  168.             to the dueller. From left to right, going down, they are:
  169.                
  170.                Shield : Extra shielding for battle.
  171.                
  172.                 Apple : The first of four icons for replenishing energy.
  173.                
  174.                  Fish : Another form of energy.
  175.                
  176.              Sandwich : Yet another form of energy.
  177.                
  178.            Red potion : A different form of energy - this one's magic!
  179.                
  180.          Green potion : A random teleport potion.
  181.          
  182.             * WALL ICONS: A set of four icons, which all act the same way, 
  183.             to make the cavern layouts.
  184.                
  185.             * TELEPORTS: Two icons, the first is a random teleport, just
  186.             like the green potion bottle. But the second one is a 
  187.             staircase teleport, which which can take you to a specific 
  188.             location of your choice. This last one needs a section of its 
  189.             own, so it will be described later.
  190.               
  191.             * PLAYERS: These icons are special, because there can never be
  192.             more than one of each of them. Both Select and Adjust can be
  193.             used to place the player icons, and if you change your mind 
  194.             about the location of either, then clicking elsewhere will 
  195.             automatically place them there, deleting their old positions.
  196.             It is quite simple really.
  197.  
  198.   /\
  199.   \/  PLACING STAIRCASE TELEPORTS
  200.   
  201.       Staircase teleports require a user defined destination in order to be
  202.       of any use. So when you place one, keep the staircase as the currently
  203.       selected icon (if you use any other, then the teleport will be wiped)
  204.       and double-click on any teleport.
  205.       
  206.       The icons window will disappear, being replaced by a new one, 
  207.       showing the destination coordinates of that teleport. In the editor
  208.       window, a purple four pointed cursor will appear over the teleport.
  209.       This shows whereabouts on the current screen the teleport will take
  210.       you to.
  211.       
  212.       You can still use the map window to select a different screen. The
  213.       cursor will stay in the same place, whether the block underneath it
  214.       is a path or not. Just click in the editor window to move the cursor
  215.       to the desired position. Or alternatively, use the bump icons to
  216.       alter the coordinates. All the windows interact and update with each
  217.       other (I hope!)
  218.       
  219.       There are two ways you can escape from this mode. You can either click
  220.       on Cancel, which will reset the current teleport's coordinates to
  221.       the same coordinates as the teleport, or click on OK, which will save
  222.       the details into memory. If the destination is over anything other
  223.       than a path icon, then you will be warned about it, and plonked back
  224.       into the mode.
  225.       
  226.       Upon exiting this mode, the teleport window will disppear, and the
  227.       icons window will reappear, returning you to normal editing mode.
  228.       I know this sounds a little scrappy, but it was the only way I
  229.       could think of addressing this procedure.
  230.       
  231.   /\
  232.   \/  HINTS, TIPS AND DESIGN RESTRICTIONS
  233.   
  234.       Here are some useful design hints and tips:
  235.       
  236.          * Save your work regularly! You never know if there is a fatal 
  237.            error or power cut round the corner.
  238.          * Don`t have too many single spaces enclosed in stone; there is 
  239.            the possibility that you may get teleported there in the game, 
  240.            causing much annoyance!
  241.          * Try and position the players starting positions as far away as
  242.            possible. It`s much more fun finding each other then!
  243.          * Don`t get your inpeneterable blocks mixed up with the 
  244.            transparent ones. Consult the Draw file “Icons” for reference.
  245.          * Make sure you have a boundary surrounding the outer fringes of
  246.            your screens, otherwise the game will crash, when you wander out!
  247.          * Make bonus rooms (places with lots of goodies) difficult to get
  248.            to (the “Complex” file is a prime example!).
  249.          * Be creative! The results may take a while to perfect, but it is
  250.            worth it in the end!
  251.            
  252.       As long as you follow these rules, you should have no trouble in 
  253.       designing some fiendish caverns! 
  254.       
  255.   /\
  256.   \/  LOADING AND SAVING CAVEFILES
  257.       
  258.       CaveFiles can be loaded into !CavernEd, by dragging them to the
  259.       !CavernEd icon on the icon bar. Other methods aren't yet possible,
  260.       any help on this would be appreciated. Saving is standard RISC OS
  261.       fashion, except that the F3 key is not supported.
  262.       
  263.   /\
  264.   \/  DISTRIBUTION OF CAVEFILES
  265.       
  266.       CaveFiles designed by !CavernEd are copyright free and may be sent
  267.       anywhere (PD libraries, ftp sites etc.). Yes, you have complete
  268.       autonomy over what to do with your CaveFiles. The only restriction is
  269.       that you cannot make a profit out of them. CaveFiles may be sent to
  270.       magazines for inclusion on their cover discs, as long as they are
  271.       termed as public domain. Do not use the magazines as a
  272.       way of earning money.
  273.       
  274.   /\
  275.   \/  KNOWN PROBLEMS WITH THE SOFTWARE
  276.   
  277.       Since this is the first release of !CavernEd, it is very basic in
  278.       use and design. Therefore, there are bound to be lots of things 
  279.       that you would like to see in future releases of the software.
  280.  
  281.       The problem is that we, the authors will not be giving our total
  282.       support to the software anymore, as we want to move onto pastures
  283.       new i.e. other programming projects. Any updates will be very few
  284.       and far between, and they will probably be just minor bug fixes,
  285.       along with the Cavern Duel game.
  286.       
  287.       One silly little problem is that the Screen Window is quite slow to
  288.       update, so try not to drag any other windows over it, otherwise it 
  289.       all gets very jerky, especially on Arm2 based machines.
  290.  
  291.       Try not to change modes too often on some machines. The Risc PC is a
  292.       case in point. The game icons may become distorted in certain modes,
  293.       such as 49. The icon sprite for !CavernEd may change to the mode 12 
  294.       equivalent, if this mode is selected. To summarise: only change mode
  295.       if you absolutely have to! This effect is very unpredictable; some
  296.       times it may be uneventful, other times it may be mildly annoying,
  297.       but never fatal!
  298.   
  299.       The current templates were defined on a Risc OS 3.5 machine, using
  300.       the Homerton desktop font. On older machines, the system font text
  301.       may not fit in the boxes, or may appear out of alignment with other
  302.       lines.  If this is the case then we apologise for this. This editor
  303.       has also been tested under version 3.97 of the window manager, as
  304.       originally included on the AcornSoft Beta CD of late 1997.  
  305.  
  306.       The software is not fully error trapped against a user's design. We 
  307.       have removed what we think are the most obvious bugs, but there may 
  308.       be others that were virtually undetectable to us, but pop up 
  309.       unexpectantly. We recommend saving your work regularly, to save 
  310.       pulling your hair out when its too late! Bugs in your caverns can 
  311.       only be found out by playtesting. Do contact us if you find any
  312.       strange bugs in your version.
  313.   
  314.       Having seen Andrew Ayre's DrWimp programming system, I can safely 
  315.       say that it is a much better system to program with, and I will be
  316.       using it for future projects.
  317.        
  318.       Features of it include the use of interactive help and message 
  319.       files for foreign users.  If this software is successful enough,
  320.       then we will get to work!
  321.       
  322.   /\
  323.   \/  FILING SYSTEMS
  324.       
  325.       The !CavernEd software is compatible with all filing systems,
  326.       except archives (if you have a read only dearchiver). If you
  327.       intend designing your own CaveFiles with !CavernEd, and have a READ
  328.       ONLY version of the archiver software (!ArcFS being the most common)
  329.       then you must dearchive the software first.
  330.       
  331.       At present, you cannot write to CD-ROMs. So, if this software came
  332.       on a public domain CD-ROM, then you must copy it to another disc or
  333.       to your hard drive system.
  334.       
  335.   /\
  336.   \/  ALTERING THE CAVEFILE FILETYPE
  337.       
  338.       The default filetype is &022, and its probable that there is another
  339.       application around, whether it is commercial or otherwise, that uses
  340.       it. To stop any unnecessary clashes, you can alter the filetype to 
  341.       one that suits you. You will require a template editor, such as
  342.       !FormEd or !TemplEd to alter the templates files that contain
  343.       references to the filetype sprites.
  344.   
  345.       But to do this will take a little while. So follow this brief guide:
  346.   
  347.          * Load !Paint. Load the !Sprites file inside !CavernEd.
  348.          * Find the sprites “file_022” and “small_022”.
  349.          * Press Menu, and go to the sprite “file_022” or whatever, and go
  350.            to the submenu. Go to Rename, to reveal the entry box. Now 
  351.            replace the “022” with your chosen filetype. Do the same with 
  352.            the other sprite.
  353.          * Save the file.
  354.          * Repeat the above procedure with the !Sprites22 file.
  355.          * Now load the !Boot and !Run file, and alter the 022 at various
  356.            lines to your chosen filetype. Resave them.
  357.          * Load !RunImage, and use the search and replace routine in the
  358.            text editor to find and replace all references to 022 with
  359.            your new filetype. Resave the file.
  360.          * Load your template editor, and load in turn both sets of
  361.            templates. Find the savebox window and change the sprite icon's
  362.            name from "file_022" to one that has the new filetype. Resave
  363.            the file.
  364.          * Do the above with the files within the !CavenDuel application.
  365.            Read the !CavenDuel documentation to find out how.
  366.  
  367.   /\
  368.   \/  CONTACTING US
  369.  
  370.       Since addresses change more often than text files, we provide only
  371.       our permanent home address, which is
  372.       
  373.       17 Northcroft Villas
  374.       Egham
  375.       Surrey
  376.       TW20 0DZ
  377.       England
  378.        
  379.       Sorry! No telephone enquiries please.
  380.  
  381.       We also have our own websites and e-mail addresses. For me,
  382.       Stephen, my addresses are;
  383.       
  384.       banwackerin@hotmail.com (this e-mail is permanent so wont go out of date)
  385.       http://www.geocities.com/SiliconValley/Pines/2760/index.html
  386.       http://www.fortunecity.com/lavendar/clint/40/index.html
  387.          
  388.       Graeme's addresses are;
  389.  
  390.       SkySoarer7@aol.com
  391.       http://members.aol.com/SkySoarer7
  392.  
  393.   /\
  394.   \/  Stephen Scott, Graeme Scott - tapestry multimedia
  395.       January 1996, August, December 1997
  396.